# _*_ codeing : utf-8 _*_
# @Time : 2025-04-12
# @Author : wxp
# @File : 4 特殊用途注释
# @Project : wxp-python

if __name__ == '__main__':
    # (1) Shebang 声明
    # 在脚本文件首行指定解释器路径（仅限 Unix/Linux）：
    """
        # !/usr/bin/env python3
    """
    # (2) 编码声明
    # 指定文件编码（Python 3 默认 UTF-8，但可显式声明）：
    """
        # -*- coding: utf-8 -*-
    """
    # (3) 类型提示注释
    # 为变量或参数添加类型提示（Python 3.5+）：
    """ 
        def greet(name: str) -> str:
        return f"Hello, {name}"
    """
    # (4) 调试或禁用警告
    # 临时禁用代码或忽略特定警告：
    """ 
        # TODO: 待完成的功能
        # FIXME: 需要修复的代码
        print("临时调试输出")  # noqa: E501  # 忽略 PEP8 行长度警告
    """
